home *** CD-ROM | disk | FTP | other *** search
/ HamCall (April 1991) / HAMCALL CD-ROM (Buckmaster)(April 1991).BIN / util / encrypt / read_me.doc < prev    next >
Text File  |  1990-10-14  |  8KB  |  269 lines
  1.  
  2. * THIS FILE CONTAINS IMPORTANT INFORMATION - READ CAREFULLY BEFORE PROCEEDING *
  3.  
  4.  
  5. DISTRIBUTION DISK
  6. -----------------
  7.  
  8. The IRIS distribution disk contains the following files:
  9.  
  10.     IRIS.EXE     - The PC-IRIS program
  11.     IRIS.DOC     - Ascii documentation for IRIS
  12.     KEYS.DAT     - Sample cipher key file
  13.     ENCRYPT.BAT     - A quick interface to IRIS for file encryption
  14.     DECRYPT.BAT     - A quick interface to IRIS for file decryption
  15.     READ-ME.DOC     - Last minute notes / revisions
  16.     REGISTER.DOC - Registration details and order form
  17.     DEMO.BAT     - DES file encryption demonstration
  18.     OZY.TXT     - Text file used by demo
  19.     IR.BAT     - Batch file to start IRIS from the root
  20.     INSTALL.BAT     - Installation procedure
  21.     MERLIN.EXE     - Encrypting COPY clone
  22.     MERLIN.DOC     - Ascii documentation for MERLIN
  23.     LOCK.EXE     - Session lock facility
  24.     LOCK.DOC     - Ascii documentation for LOCK
  25.  
  26.  
  27. INSTALLATION 
  28. ------------
  29.  
  30. The INSTALL procedure will create a directory '\IRIS', and copy the required 
  31. files into it. The command format is:
  32.     INSTALL source-drive target-drive
  33.  
  34. If you have a hard disk C:, load your distribution diskette in Drive A:, 
  35. and issue the command:  A:INSTALL A C
  36.  
  37. Note that the IRIS.BAT procedure will need to be edited if your hard drive
  38. is not 'C'. IRIS.BAT does not pass parameters to the IRIS executable, so do
  39. not attempt to pass command parameters when invoking IRIS via this procedure.
  40.  
  41. If you are using a twin floppy machine, just copy the distribution diskette,
  42. store the distribution as backup and use the copy as-is.
  43.  
  44.  
  45. The ENCRYPT and DECRYPT batch files
  46. -----------------------------------
  47.  
  48. ENCRYPT.BAT and DECRYPT.BAT provide an quick interface to IRIS 
  49. for DES file encryption and decryption. Usage is thus:
  50.  
  51.     ENCRYPT filename DES-key or DES-keyphrase
  52.  
  53.     DECRYPT filename DES-key or DES-keyphrase
  54.  
  55. Eg:
  56.     ENCRYPT ozy.txt 43-23-F9-C2-55-7E-1F-B3
  57.     DECRYPT ozy.txt 43-23-F9-C2-55-7E-1F-B3
  58.  
  59. Or:
  60.     ENCRYPT ozy.txt bewaretheidesofmarch
  61.     DECRYPT ozy.txt bewaretheidesofmarch
  62.  
  63.  
  64. Authenticating the IRIS program image
  65. -------------------------------------
  66.  
  67. The CCITT checksums for IRIS are listed below. Check that your IRIS
  68. program is correct and unaltered with: IRIS checksum /file=iris.exe
  69.  
  70.     IRIS v3.5-1     CCITT: 6371
  71.     IRIS v3.6-3     CCITT: 7B7A
  72.     IRIS v3.7-0    CCITT: DB4E
  73.  
  74.  
  75. Registration
  76. ------------
  77.  
  78. UNMODIFIED copies of PC-Iris, PC-Merlin and PC-Lock may be given to others 
  79. for evaluation. These programs CANNOT be sold without written permission 
  80. from Digital Crypto.
  81.  
  82. If you intend to make use of any Digital Crypto product, we would appreciate
  83. your prompt registration. In return for registration you will receive:
  84.  
  85.       The latest Digital Crypto disk
  86.       The latest full documentation set
  87.       A license agreement
  88.       Update notification
  89.       Telephone support / technical advice
  90.  
  91. Single PC registration is $39.00 (USD) or equivalent local currency
  92. Payment to DIGITAL CRYPTO at:     DIGITAL CRYPTO
  93.                                   PO BOX 1
  94.                                   Penarth
  95.                                   South Glamorgan
  96.                                   United Kingdom  CF6 2WB
  97.  
  98. Telephone UK: (0222) 711370      18:00 - 23:00 GMT
  99.  
  100. Contact Digital Crypto direct for details of VMS-Iris / UNIX-Iris / OS2-Iris,
  101. access to source code / cipher libraries, customization, site licensing etc.
  102.  
  103.  
  104. Features new to V3.7
  105. --------------------
  106.  
  107. F1. Keyphrase packing for DES
  108.  
  109.     It is now permissable to supply a 'keyphrase' to the DES cipher
  110.     which will be packed into a pure DES key by CIPHER.  Many users
  111.     will find this preferable, as the pure HEX DES key format is 
  112.     difficult to remember.
  113.  
  114.     IRIS applies several heuristic checks to decide if a keyvalue
  115.     entered is in pure-DES, or keyphrase-pack format.
  116.  
  117. F2. /[NO]ERASE qualifier syntax change
  118.  
  119.     The /[NO]ERASE qualifier has been replaced by:
  120.  
  121.     /ERASE=AUTOMATIC    Automatically erase input file after 
  122.                 encrypt or decrypt operation.
  123.  
  124.     /ERASE=CONFIRM        Prompt the user to confirm that input
  125.                 file erasure is required, after encrypt
  126.                 or decrypt operation
  127.  
  128.     /ERASE=NONE        Do not erase the input file after encrypt
  129.                 or decrypt operation
  130.  
  131. F3. /DEBUG qualifier
  132.  
  133.     The /DEBUG qualifier causes the display of internal data structures 
  134.     created during PLAYFAIR and BAZERIES encryption / decryption.
  135.  
  136. F4. /[NO]CONTROL new qualifier
  137.  
  138.     The /[NO]CONTROL qualifier control processing of non-printable
  139.     input plaintext.
  140.  
  141.     /[NO]CONTROL    -     Skip non-printable plaintext
  142.     /CONTROL    -     Process non-printable plaintext
  143.  
  144. F5. /[NO]PUNCT new qualifier
  145.  
  146.     The /[NO]PUNCT qualifier control processing of punctuation
  147.     characters in input plaintext.
  148.  
  149.     /[NO]PUNCT    -     Skip punctuation characters
  150.     /PUNCT        -     Process punctuation characters
  151.  
  152. F6. Case sensitivity of /KEYVALUE preserved
  153.  
  154.     The case (upper or lower) of supplied keyvalues is now retained
  155.     and passed to the CIPHER program. This increases the available
  156.     keyspace dramatically, and thereby improves security, but users
  157.     should be aware that if they encrypt with 'INTHEBEGINNING' and
  158.     then decrypt with 'inthebeginning', plaintext will NOT result.
  159.  
  160. F7. /ECHO_PLAIN and /ECHO_CIPHER filter non-printable characters
  161.  
  162.     The echoing of plain and cipher text is now filtered to only
  163.     display printable characters.
  164.  
  165. F8. Temporary files now have '.XYZ' extension
  166.  
  167.     Temporary files left behind when IRIS is terminated prematurely
  168.     via CTRL-BREAK etc, now have the extension '.XYZ'. This makes 
  169.     IRIS temporary files easier to locate and delete.
  170.  
  171. F9. New checksum algorithm provided: BYTESUM
  172.  
  173.     The bytesum algorithm provides a simple arithmetic sum
  174.     (modulo wordsize) of all the bytes in a file.
  175.  
  176. F10. Weak & Semi-weak key detection for DES
  177.  
  178.     Weak and Semi-weak DES keys are now rejected by the key
  179.     validation module.
  180.  
  181. F11. BAZERIES cipher algorithm
  182.  
  183.     IRIS now supports an extended version of the Bazeries cylinder.
  184.  
  185. F12. Block count display during CIPHER
  186.  
  187.     IRIS will display a count of block size and blocks processed
  188.     during cipher operations. /BRIEF will suppress this feature,
  189.     as will /ECHO_PLAIN or /ECHO_CIPHER.
  190.  
  191. F13. VERNAM cipher improved
  192.  
  193.     The random number generator implemented in IRIS v3.5 was found
  194.     to be inadequate, and has been replaced by a scheme using both
  195.     additive and linear quadratic methods, with produces a period
  196.     of roughly 2^55.
  197.  
  198.     WARNING: PC-IRIS VERNAM v3.7 is incompatible with PC-IRIS
  199.          VERNAM v3.5 - Do not use one with the other !!!
  200.  
  201.     Performance of VERNAM has been enhanced by increasing the i/o
  202.     blocksize to 255 bytes.
  203.  
  204. F14. IRIS image now returns exit codes
  205.  
  206.     The IRIS image returns exit codes which indicate completion
  207.     status thus:
  208.  
  209.         exit code
  210.  
  211.            0    Normal completion
  212.            1    Abnormal completion
  213.            2    Terminated by user (CTRL-BREAK)
  214.  
  215. F15. Message handler changes
  216.  
  217.     The format of IRIS error messages has changed from:
  218.  
  219.     %IRIS-E-SOMERR, some error has occurred
  220.  
  221.     To:
  222.  
  223.     ERROR: SOMERR, some error has occurred
  224.  
  225.     The message handler now 'beeps' when errors of severity
  226.     WARNING, ERROR and FATAL are issued.
  227.  
  228. F16: Qualified error messages
  229.  
  230.     Some error messages (mainly I/O errors) now have an additional 
  231.     qualification string giving additional information about the
  232.     reason for the error condition.
  233.  
  234. Bugs fixed:
  235. -----------
  236.  
  237. B1. /NOSPACE padded blocks with EOF characters
  238.  
  239.     The /NOSPACE qualifier did not re-pack blocks when space characters
  240.     were removed. The short blocks were then padded with EOF characters
  241.     which made decrypted plaintext appear to be truncated. This problem
  242.     has been fixed.
  243.  
  244. B2. AMORPHFAIL error fixed
  245.  
  246.     A bug in the command parser caused the AMORPHFAIL error to occur 
  247.     whenever the user entered /KEYVALUE in full. (/KEYVAL worked fine).
  248.     Several other parser enhancements have also been introduced.
  249.  
  250.  
  251. Software changes:
  252. -----------------
  253.  
  254. C1. /[NO]LOWER qualifier syntax changed
  255.  
  256.     The /[NO]LOWER qualifier has been replaced by:
  257.  
  258.     /[NO]UPCASE
  259.  
  260. C2. /[NO]ECHO_PLAIN qualifier default value changed
  261.  
  262.     /ECHO_PLAIN now defaults to false. (Because of block count feature).
  263.  
  264. C3. /ECHO_PLAIN and /ECHO_CIPHER prohibited
  265.  
  266.     Use of /ECHO_PLAIN and /ECHO_CIPHER in the same cipher command
  267.     is prohibited, and will generate a 'NOTBOTH' warning error and
  268.     NO echoing of text at all.
  269.